Theming

Modify a defined theme

Access to the folder where the template is defined (below in according with the default configuration):

/usr/lib/python2.7/site-packages/theme_name

A theme package is defined with this files structure:

-rw-r--r--. 1 root root   88 13 mag 15.51 404.html
drwxr-xr-x. 5 root root 4096 13 mag 15.51 assets
-rw-r--r--. 1 root root 8857 26 mag 23.30 base.html
-rw-r--r--. 1 root root    0 13 mag 15.51 __init__.py
-rw-r--r--. 1 root root  145 13 mag 15.51 __init__.pyc
-rw-r--r--. 1 root root   26 13 mag 15.51 main.html
-rw-r--r--. 1 root root 2678 13 mag 15.51 theme_name.yml
drwxr-xr-x. 4 root root 4096 26 mag 23.33 partials

The partials folder contains the page elements as header, footer and other stuffs

-rw-r--r--. 1 root root 2427 26 mag 23.33 footer.html
-rw-r--r--. 1 root root 2049 13 mag 15.51 header.html
-rw-r--r--. 1 root root  284 13 mag 15.51 hero.html
drwxr-xr-x. 2 root root 4096 13 mag 15.51 integrations
drwxr-xr-x. 2 root root 4096 13 mag 15.51 language
-rw-r--r--. 1 root root  421 13 mag 15.51 language.html
-rw-r--r--. 1 root root  907 13 mag 15.51 nav.html
-rw-r--r--. 1 root root 1975 13 mag 15.51 nav-item.html
-rw-r--r--. 1 root root 1115 13 mag 15.51 search.html
-rw-r--r--. 1 root root  390 13 mag 15.51 social.html
-rw-r--r--. 1 root root  853 13 mag 15.51 source.html
-rw-r--r--. 1 root root  369 13 mag 15.51 tabs.html
-rw-r--r--. 1 root root 1161 13 mag 15.51 tabs-item.html
-rw-r--r--. 1 root root 1294 13 mag 15.51 toc.html
-rw-r--r--. 1 root root  387 13 mag 15.51 toc-item.html

Each html file can be customized with a set of template variables defined with Jinja-2 syntax.